home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / grapprog / pep.zip / CHAPT5.TXT < prev    next >
Text File  |  1994-06-22  |  8KB  |  156 lines
  1. <Chapter 5:  Collecting Elements>
  2.      The commands in the COLLECT menu allow you to select multiple
  3. elements from the open object, and then to convert them into a group, a
  4. filled region, or an object. (You can also delete all the selected
  5. elements). Use the six commands at the top of the menu (ALL, EXCEPT,
  6. SINGLE, INSIDE, TOUCHING, and PROPERTIES)  to specify which elements you
  7. want to collect. The commands can be used in combination to select and
  8. deselect multiple elements in a variety of ways as described below. The
  9. three commands at the bottom of the menu (OBJECT, GROUP, and DELETE)
  10. terminate the selection process and specify the operation to be performed
  11. on the selected elements. To abort the collection process at any time,
  12. type Q (for QUIT) or ESC to return to the top menu.
  13.  
  14. <Section 5.1:  All>
  15.      The COLLECT/ALL command causes all elements in the open object to be
  16. selected.
  17.  
  18. <Section 5.2:  Except>
  19.      Use the COLLECT/EXCEPT command to switch from selecting elements to
  20. un-selecting and back again. It is a multiple choice command and has two
  21. values: OFF (elements chosen by the user are being selected) and ON
  22. (elements are being un-selected).
  23.  
  24.      If EXCEPT is OFF, only elements not yet selected can be chosen by the
  25. user, and once chosen they become selected. If EXCEPT is ON, only elements
  26. already selected can be chosen, and once chosen they become no longer
  27. selected.
  28.  
  29.      For simplicity, the discussion below assumes that EXCEPT is OFF and
  30. elements are being selected. However, the same procedures apply if you
  31. have turned EXCEPT ON, and are un-selecting elements previously collected.
  32.  
  33.      For example, to select everything except one particular element,
  34. first use the ALL command to select everything. Then turn EXCEPT ON, and
  35. use the SINGLE command to de-select the one exceptional element.
  36.  
  37. <Section 5.3:  Single>
  38.      Use the COLLECT/SINGLE command if you want to select individual
  39. picture elements, one at a time. When you press the command letter, a
  40. cross-hair cursor appears; position the cursor and press RETURN. PEP finds
  41. the picture element nearest to the cursor and displays a box around that
  42. element. (This element is also displayed in the preview window.) Press
  43. RETURN again to accept, or SPACE to reject this choice. If you accept it,
  44. the boxed element is added to the collected elements and the cross-hair
  45. reappears in preparation for selecting another element. If you reject the
  46. boxed element, PEP finds the next closest and displays a box is around it.
  47. During this process, an element once collected is not available for
  48. selection later.
  49.  
  50. <Section 5.4:  Inside>
  51.      The COLLECT/INSIDE command provides one method for selecting several
  52. elements at once. To use it, press the command letter, position the
  53. cross-hair cursor, and press RETURN. The crosshair cursor is replaced by a
  54. stretchable box cursor whose upper left corner is located at the chosen
  55. point. Stretch this box so that it surrounds the elements you want to
  56. select and press RETURN again. All elements contained entirely inside the
  57. box are selected. The cross-hair cursor reappears in preparation for
  58. repeating the process.
  59.  
  60. <Section 5.5:  Touching>
  61.      The COLLECT/TOUCHING command provides a second method for selecting
  62. several elements at once. The selection process is exactly the same as for
  63. the INSIDE command above with one exception: now all elements are selected
  64. which intersect the box cursor, whereas, with the INSIDE command, selected
  65. elements were required to be entirely inside the box. Note: an element is
  66. considered to be touching a specified rectangle if the smallest box
  67. containing the element intersects the rectangle, even if the element
  68. itself does not intersect. In <[FIG01]>, the straight line A qualifies as
  69. touching the stretchable box cursor B because a box C drawn around A would
  70. intersect with B.
  71.  
  72. <Section 5.6:  Properties>
  73.      By using the COLLECT/PROPERTIES command you can limit the selection
  74. process to certain types of elements or elements with certain properties.
  75. For example, you can restrict attention to red elements or to lines only.
  76. This is a multiple choice command with two values: DISABLED (all elements
  77. are available for selection) and ENABLED (only elements matching the
  78. properties template are available for selection). When the template is
  79. first enabled, a new menu is displayed to show the current template and to
  80. allow the user to change it.
  81.  
  82.      After you set a property in the template, only elements having that
  83. property can be selected. If two or more properties are used, only
  84. elements having both properties can be selected. You should be careful not
  85. to use contradictory properties, as then no selection can happen at all.
  86. For example, if the template specifies a fill pattern, only filled regions
  87. can be selected. If a justification is specified, only text labels can be
  88. selected. Thus if both are specified, no selection can take place as no
  89. element can have both properties.
  90.  
  91.      To turn off a field in the template, choose the value NONE for that
  92. field.
  93.  
  94. <Section 5.6.1:  Element>
  95.      Use the COLLECT/PROPERTIES/ELEMENT command to restrict selection to
  96. elements of a certain type. Press the command letter to display a menu of
  97. choices. The choices are: LINE (all types of lines are accepted),
  98. HORIZONTAL (only horizontal lines are accepted), VERTICAL, STRAIGHT,
  99. RIGHTANGLE, CURVE, GROUP (both types of groups are accepted: PLAIN and
  100. FILLED), PLAIN (only plain groups are accepted), FILLED (only filled
  101. regions are accepted), OBJECT, TEXT, and NONE.
  102.  
  103. <Section 5.6.2:  Justify>
  104.      Use the COLLECT/PROPERTIES/JUSTIFY command to restrict selection to
  105. text labels with a certain justification. It is a multiple choice command
  106. with five values: CENTER, LEFT, RIGHT, EVEN and NONE.
  107.  
  108. <Section 5.6.3:  Font>
  109.      Use the COLLECT/PROPERTIES/FONT command to restrict selection to text
  110. labels using a certain font. It is a multiple choice command with seven
  111. values: the six possible fonts and NONE.
  112.  
  113. <Section 5.6.4:  Pattern>
  114.      Use the COLLECT/PROPERTIES/PATTERN command to restrict selection to
  115. filled regions with a given fill pattern. Press the command letter to
  116. display a menu of 17 choices: the 16 fill patterns and NONE.
  117.  
  118. <Section 5.6.5:  Color>
  119.      Use the COLLECT/PROPERTIES/COLOR command to restrict selection to
  120. elements with a given color. Press the command letter to display a menu of
  121. 17 choices: the 16 colors and NONE.
  122.  
  123. <Section 5.6.6:  Rotation>
  124.      Use the COLLECT/PROPERTIES/ROTATION command to restrict selection to
  125. text labels and objects having a given rotation. Press the command letter
  126. to display a menu of 9 choices: the 8 rotations and NONE.
  127.  
  128. <Section 5.6.7:  Name>
  129.      Use the COLLECT/PROPERTIES/NAME command to restrict selection to
  130. objects of a given type. Press the command letter to display a menu of
  131. object names including /NONE/.
  132.  
  133. <Section 5.6.8:  Initialize>
  134.      The COLLECT/PROPERTIES/INITIALIZE command resets every entry in the
  135. template to NONE. In this state, every element in the open object will
  136. match the template.
  137.  
  138. <Section 5.7:  Object>
  139.      The COLLECT/OBJECT command terminates selection and converts all
  140. selected elements into an OBJECT. Press the command letter and type in a
  141. name for the object. A MODIFY-OBJECT menu is then displayed. See Chapter
  142. <[4]> for descriptions of each of the commands in this menu. To return to
  143. the PEP main menu, simply QUIT from the MODIFY-OBJECT menu.
  144.  
  145. <Section 5.8:  Group>
  146.      The COLLECT/GROUP command terminates selection and converts all
  147. selected elements into a GROUP. A MODIFY-GROUP menu is then displayed. See
  148. Chapter <[4]> for descriptions of each of the commands in this menu. To
  149. return to the PEP main menu, simply QUIT from the MODIFY-GROUP menu.
  150.  
  151. <Section 5.9:  Delete>
  152.      The COLLECT/DELETE command terminates selection and deletes all
  153. selected elements from the open object. PEP continues to display the
  154. COLLECT menu. The UN-DELETE command <[3.1]> in the main menu can be used
  155. to recover the deleted material.